home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / Disk Of The Month 26.adf / Doc-Files / Graphics.Doc < prev    next >
Text File  |  1988-06-19  |  12KB  |  312 lines
  1.  
  3. Graphics Docs
  5. This file includes Documentation for all files in the Graphics Drawer. They 
  6. have all been combined into one to save disk space.
  7.  
  8. The Docs included in this file are:
  10. Amiga Plot
  11. ScrollBench
  12. CCFlip
  13. SFlip
  15.  
  16. Doc File Headers are in RED!
  17.  
  18.  ****************************************************************************   
  19.  
  20.             Amiga Plot V1.3a Joe Martin 7/88  (C)Copyright 1988
  22.  
  23.     This program is not public domain. All rights retained. Permision is
  24. granted to freely distribute this program as long as all documentation and
  25. notices remain intact. Charges for such distribution are NOT permitted except
  26. as a nominal disk charge !! 
  27.     
  28.  If you find this program useful, entertaining or educational, please donate
  29. $20 to the author. Source code is available for an additional $20 by sending
  30. check or money order to the address provided below. Donations will encourage
  31. updates and more features.
  32.  
  33. ****************************************************************************
  34.  
  35.  
  36. Amiga Plot is a three dimesional mathematical function plotter.It takes
  37. a function, derived by the user, parses it into a partially compiled form and
  38. then calculates coordinates to be placed in the xyz system. AmigaPlot use
  39. hidden line removal based on a principle known as the painters algorithm. 
  40. Each time AmigaPlot goes to the screen it places a filled polygon. Starting
  41. from the most distant part of the plot it is constantly placing filled
  42. polygons in front of other polygons there by covering the hidden portions of
  43. the plot. Many aspects of the plot are user variable so that almost any
  44. combination of rotations, perspectives, and parameters for any function can
  45. produce infinite results. AmigaPlot is not intended for statistical analysis
  46. and the precision of the plot or its scale are not guaranteed.
  47.     The use of color in the plot can produce very pleasing effects
  48. especially when a feathered pallet is used. The idea of AmigaPlot is to
  49. provide an artistic approach to the sometimes dry subjects of Analytical
  50. Geometry and Trigonometry.
  51.  
  52.  
  53.     AmigaPlot was compiled on the Aztec C Compiler 3.6a
  54.     **** Minimum memory 512K - it uses most of it *****
  55.     ************ 1 or 2 meg recommended **************
  56.  
  57.  
  58. ****************************************************************************
  59.  
  60. known bugs:
  61.  
  62.     1-some functions can produce values out of range.
  63.     2-extreme values can burden the Amiga clipping routines by requiring 
  64.         more chip memory than is available ! 
  65.         (I've tried to help them out a little)
  66.     3-Rotations approaching 90 degrees will give distorted results(not 
  67.         really a bug)
  68.     I'm working on better error checking but it'll be slow to come.
  69.     The Parser does very little error checking right now so watch your
  70.         spelling on trig function names.
  71.  
  72. ****************************************************************************
  73.  
  74. 1.3a 
  75.     -Fixed bug in file requestor that didn't follow paths correctly.
  76.     -Loads in special Images for windows etc.(3.6a would have booted me out 
  77.      of small data otherwise.
  78.     -User friendly rotation parms(degrees) and smoothing parms(xincr and
  79.         yincr).
  80.         
  81. ****************************************************************************
  82.  
  83. 1.3 additions:
  84.  
  85.     1- save/load parameters and IFF support.
  86.     2- macro capability in function window.
  87.     3- sample functions(parms directory).
  88.     4- increased color span resolution to include floating point.
  89.     5- cosmetic window update.
  90.  
  91. Let's get to it !
  92.  
  93. ********** First MAKE SURE YOUR STACK IS SET TO AT LEAST 20000 *************
  94.  
  95. AmigaPlot is initialized at the CLI by 'Run Plot' (don't forget to set stack
  96.                             20000 first !)
  97.  
  98.     For convenience, the directory 'parms' is included and includes numerous
  99. function examples. These can be loaded from the 'Files' menu and make it
  100. extremely easy to play with and to alter different functions known to yield
  101. satisfatory results.
  102.   Also the directory 'pic' is included with one example of an Iff pic. This
  103. picture can be viewed with any showiff program.
  104.                             
  105. Three windows appear-
  106.     1- AmigaPlot window - for the plots.
  107.     2- Parms window     - gadgets to select and change parameters.
  108.     3- Function window  - for function input only.
  109.  
  110. There are three menus available for some parmameter changes, color etc.
  111.  
  112. Parms Window:
  113.  
  114. Gadgets: 
  115.     Start    starts plot
  116.  
  117.     Stop      stops plot in progress. Any parameter changes will go
  118.             into effect when the plot is restarted.
  119.  
  120.     YRot    changes perspective about the Y axis. range -90 - 90 degrees
  121.     XRot    changes perspective about the X axis. range -90 - 90 degrees 
  122.  
  123.     Object  changes depth perspective in conjuction with Image
  124.         distance from viewer to object
  125.     Image    changes depth perspective in conjuction with Object
  126.         distance from viewer to Image
  127.     
  128.     XRan    This number represents the the outside dimensions of the loop
  129.         which will provide a value for the 'X' variable in the func-
  130.                 tion. Ex XRan: 10 means a loop from -10 to 10
  131.     YRan    Dimensions the loop for the Y variable in the function
  132.  
  133.     Suggested ranges are from 25 down to 5. 
  134.  
  135.     XIncr    the step increment for the XRan loop 1 - 8
  136.     YIncr    the step increment for the YRan loop 1 - 8
  137.  
  138. Adjusting the X and Y increments will give the plot a smooth or jagged
  139. appearence on most plots. Smaller increments take a lot longer to plot(much
  140. more computing), but produce better pictures. '1' is smoothest, '8' coarsest.
  141.  
  142.     XTrans    this moves the center of the plot about the X axis
  143.     YTrans    this moves the center of the plot about the Y axis
  144.  
  145.     ScX    this will adjust the width of the plot by the Scale factor
  146.     ScY    this will adjust the height of the plot by the Scale factor
  147.  
  148.  
  149. Function Gadgets:
  150.  
  151. There are 3 string gadgets available for function input:
  152.  
  153.     f(x,y): this gadget is for entry of main function. Upper and lower case 
  154.             is acceptable. Any operators, grouping sysbols, or trig function
  155.             names given below are acceptable.   
  156.  
  157.             Legal variable names : X,Y,A,B
  158.             
  159.     A=    : this gadget is useful for subfunctions and expressions and serves
  160.             as a macro for the main function f(x,y). If your main
  161.             function(f(x,y)) contains the 'A' variable, then this macro MUST
  162.             be defined in this gadget !
  163.             
  164.     B=    : this gadget is useful for subfunctions and expressions and serves
  165.             as a macro for the main function f(x,y). If your main
  166.             function(f(x,y)) contains the 'B' variable, then this macro MUST
  167.             be defined in this gadget !
  168.             
  169.     Editing : same as for any string gadget - cursor keys, del, backSp 
  170.                   etc.
  171.  
  172.     operations :      +,-,*,/ divsion by zero is trapped.
  173.                     ^ to the power of
  174.                     
  175.     grouping   :    ()
  176.     
  177.     functions  :    ABS() absolute value of
  178.                     SQRT() Square root of
  179.                     SQR() Square of
  180.                     SIN() Sine of
  181.                     ASIN() ArcSine of
  182.                     COS() Cosine of
  183.                     ACOS() ArcCosine of
  184.                     TAN() Tangent of
  185.                     ATAN() Arctangent of
  186.                     LN()  Natural Logarithm of
  187.                     LOG() Base 10 Log of
  188.                     EXP() Exponential of
  189.  
  190. Menus:
  191.  
  192. File Menu     
  193.  
  194.  Quit -            Quit AmigaPlot (bye)
  195.  save
  196.     parms -     this will save all parameters for easy retrieval. A file
  197.                 requestor will prompt you for the file name. File name
  198.                 extensions of '.parms' are recommended.. 
  199.                 
  200.     IFF -       this will save the current visible screen to an IFF format
  201.                 image. A file requestor will prompt you for the file name and
  202.                 extensions of '.pic' are recommended.
  203.  
  204.  load
  205.     parms-      this will load a set of parameters, functions, window sizes,
  206.                 color map etc. When plot is first run 'Default.parms' is
  207.                 loaded if available. If you have a favorite function. then it
  208.                 can be loaded at startup by saving its' parms as
  209.                 'Default.parms'.
  210.                 
  211. Parameters Menu -     Same as the Parms gadgets(just for convience)
  212.  
  213. Display Menu -     
  214.  
  215.  Color Map - User selects color palette
  216.  
  217.  ColorSpan - User selects color position/span(what heigth you want each color
  218.              to kick in. Decimal fractions can be entered for 
  219.                         finer color resolution.
  220.              
  221.  XHatch -    Outlines complete polygon on screen
  222.  
  223.  Spec.Parms -    Two gadgets:
  224.  
  225.       Clip TAN - This is an adjustment for the TAN function which usually 
  226.             produces very high values(out off range). You can
  227.             adjust the tops of these spikes.
  228.             
  229.     Scale/0  - This one can adjust any case of division by zero. In other
  230.         words, instead of dividing by zero(which is undefined)
  231.         you can divide by the scale value.
  232.  
  233.     
  234. ****************************************************************************
  235.  
  236.     Here are some sample functions :
  237.  
  238. 1) COS((X^2+Y^2)/10)
  239.    Object:50    Image:650      XRange:10    YRange:10    XYIncr:.5
  240.  
  241. 2) 2*SIN((X^2-Y^2)/10)
  242.    Object:50    Image:650      XRange:10    YRange:10    XYIncr:.5
  243.  
  244. 3) .005*((X/Y)^2-(Y/X)^2)
  245.    Object:50    Image:650      XRange:10    YRange:10    XYIncr:.5
  246.  
  247. 4) 3*SIN(-.05*(X^2-Y^2))-2*COS(.1*(X^2+Y^2))
  248.    Object:50    Image:650      XRange:10    YRange:10    XYIncr:.5
  249.  
  250. 5) 4*(5*EXP(-(X^2+Y^2)/60)*SIN((X^2-Y^2)/10))
  251.    Object:130    Image:750      XRange:20    YRange:20    XYIncr:.5
  252.  
  253. 6) TAN((X^2+Y^2)/50)
  254.    Object:80    Image:750      XRange:12    YRange:12    XYIncr:.5
  255.  
  256.  
  257.         **** Have Fun ****
  258.  
  259. ****************************************************************************
  260.     
  261.  
  262.                                ScrollBench
  263.  
  264.                       Public Domain 1988  Greg Searle
  266.      Here's an interesting toy.  This will turn your Workbench screen into a
  267. low-resolution, scrolling screen.  This is useful if you get tired of
  268. flickering interlace, or if you are using tiny fonts to make more space.
  269. When active, this will maintain the Workbench at low-resolution, scrolling
  270. the screen under the mouse pointer as the mouse moves.  Restore the screen
  271. by closing the "ScrollBench" window.
  272.  
  273.      Warning:  If you are using an interlaced Workbench, don't use the
  274. dragbar!  This is a bug that I must research.  Pulling the screen down will
  275. risk making parts inaccessable, including the ScrollBench window's close
  276. box.  This program is somewhat a hack, but it behaves pretty well.
  277.  
  278.      Since the screen is low-res, the video chip will allow more bitplanes
  279. and will not compete as much for the bus.  For example, you may use both
  280. WBKaleidoscope and Dropshadow at the same time.
  281.  
  282.      Workbench will behave normally under this program, with the exception
  283. of the automatic scrolling.  Remember that dragged items may not be wholly
  284. visible as you move them.
  285.                                  - Have Fun!
  286.  
  287. ****************************************************************************
  288.    
  289.                                 CFlip & SFlip
  290.  
  292. CFlip
  293.     Here's Yet Another Screen Hack I wrote in a moment of boredom.
  294. Type "Cflip", and observe. Try typing a few other commands, like "list".
  295. Type "Cflip" again to restore (or do anything which affects screen
  296. ordering/position (e.g. Left-Amiga-N)).
  297.  
  298.     For some reason or other this doesn't work reliably if you have more
  299. than the Workbench screen open. It won't crash the machine, but it won't
  300. have the desired effect.
  301.  
  302.                 - William Rucklidge
  303.                   rucklidg@svax.cs.cornell.edu
  304. SFlip
  305. I couldn't resist!  After seeing "tilt", I had to do it (took 2 hours.)
  306. This one is written in assembly language (828 bytes!), and the source code
  307. is included.  Slower than tilt or melt because of pixel manipulation.
  308. This should be instructive for those learning assembly.  ---Mike
  309.  
  310. AMIGA FLIP WORKBENCH SILLY GURU-LIKE EFFECT
  311.  
  312.